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DESCRIPTION OF THE INVENTION 

Field of the Invention 

[001] The present invention relates to methods and systems for providing 
comments within source code. 

Background of the Invention 

[002] In current source code compilers and editors, it is possible to insert 
comments into source code. These comments provide programmers with 
information about the particular part of the source code, e.g., what the initial intention 
of a particular part of source code was, and what it does. Also, comments allow 
programmers to include certain remarks and thoughts in the source code, by which 
they are able to reconstruct their initial thoughts during programming. Further, 
comments allow including version information as well as other information. 

[003] One drawback of these comments is that they are in plain text within 
the source code. Every change within the comments results in a change of the 
source code. If the source code is delivered to customers, they are able to read the 
comments within the source code. Often, these comments are not intended for the 
public. 

[004] Also, comments are mostly written in the language of the programmer. 
However, companies that operate internationally often assign programming tasks to 
more than one programming team and the members of the programming teams may 
reside in different countries. Therefore, comments within the source code 
associated with a single project may be in several different languages. In cases 
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such as these, programmers from one country might not be able to read the 
comments of programmers from another country unless all comments within the 
source code are translated into one common language or all comments are 
translated into all of the languages spoken by the team members. Translating all 
comments into different languages not only is time-consuming but often results in 
different versions of source code which, in turn, increases the probability of version 
conflicts and other incompatibilities. 

SUMMARY OF THE INVENTION 

[005] The present invention provides a computer-implemented method for 
associating comments with source code, the method comprising, storing the 
comments separately from the source code, and, identifying where each of the 
comments is associated with the source code. 

[006] According to certain embodiments, the comments are stored 
separately from the source code, the comments are retrieved from their storage 
medium, and the retrieved comments are included into the source code. The 
separation of the storage of the comments from the storage of the source code may 
exist on any level such as, for instance, a physical level (e.g., different media) or an 
electronic level (e.g., same media, different folders, files, or portions within a file). 

[007] By storing the comments separately from the source code, access to 
the comments may be controlled. Storing the comments separately from the source 
code results in providing the source code without comments at first. One advantage 
of this may be that users of the source code, e.g., customers, do not see directly 
which comments are included within the source code. 
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[008] The comments, once stored separately, may be manipulated without 
manipulating the source code. For presenting the comments together with the 
source code, the comments are retrieved from their storage medium. As the 
comments are associated with the source code, it may be identified where each of 
the comments is associated within the source code. After retrieval, these comments 
may be included into the source code. The source code editor programs may then 
present the source code together with the comments. By the association of 
comments and source code, the position of the comments in the source code may 
be defined. The comment may be positioned correctly within the source code. 

[009] To allow management of comments, in particular access management, 
embodiments of the present invention provide the comments within the source code 
based on filter information. The filter information defines which comments are 
included within the source code for certain users. Filter information may also be 
used to define which comments are retrieved and/or presented within the source 
code. 

[01 0] To provide filtering of the comments during retrieval, embodiments of 
the present invention may assign the filter information to the comments. During the 
creation of the comments, certain filter information may be stored with each 
comment or each group of comments. During retrieval of the comments, this filter 
information is checked. If the filter information allows access to the comments for 
the requesting user, the comments may be provided. The filter information thus 
allows an embodiment to block a requesting user from having access to certain 
comments. 
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[01 1] To allow individual access to the comments, in particular for different 
users or user groups, certain embodiments of the present invention transmit access 
authorisation information to the storage medium when accessing the comments. 
The access authorisation information is compared with the filter information assigned 
to the comments, and the comments are only provided if the filter information 
matches the access authorisation information. The access authorisation information 
may comprise information about a user, a user group, a source code version, a 
source code language or any other information, which may be used for defining 
access authorisation to the source code. This information is transmitted to the 
storage medium, where it is analysed. During analysis of this information, the 
authorisation information is compared with the filter information assigned to the 
comments. For each comment, filter information may be stored, whereby access to 
the particular comment may be managed. In the event that the current access 
authorisation information matches the filter information, e.g. the filter information 
defines access permission for this particular comment, the comment is provided. 
Otherwise, accessing the comment may be blocked. Hence, access to the 
comments may be managed within the storage medium, e.g. a database, of the 
comments. The editing means for editing the comments do not comprise the 
comments themselves, the comments are rather stored separately, and access to 
the comments is managed separately from the source code. 

[012] In certain embodiments of the present invention, when retrieving the 
comments from the storage medium, the access authorisation information has to be 
provided. Therefore, in this scenario, access authorisation information is retrieved 
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prior to retrieving the comments from the storage medium, the access authorisation 
information determining whether the comments may be accessed. This retrieval of 
access authorisation information may be carried out, for instance, by prompting a 
user for a user account and a user password, determining user role, analysing 
source code version, retrieving language information, or any other information 
suitable for managing the access to the comments. After the access authorisation 
information is retrieved, this access authorisation information may be transmitted to 
the storage medium and access management may be executed there. 

[01 3] To enable easy access to the comments, certain embodiments of the 
present invention include links providing storage information of the stored comments 
within the source code. The links may comprise file names, directory information, 
path information, database queries or any other appropriate information for retrieving 
data from a storage medium. These links may be read by editing means and used 
for retrieving the comments from the storage medium. 

[014] Assigning filter information to the links for filtering the comments allows 
access management within the editing means, insofar as filter information is already 
stored within the source code, e.g., together with the links. This filter information 
may be used to define whether a link may be used or not. 

[015] To provide access management to the links, certain embodiments of 
the present invention may compare access authorisation information with the filter 
information assigned to the links when accessing the links and only use the links for 
retrieving the comments if the filter information matches the access authorisation 
information. Access authorisation information may be the same as defined above. 
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A link might only be accessible if the access authorisation information matches 
access information defined in the filter information. 

[016] To allow flexible access management, certain embodiments of the 
present invention may retrieve access authorisation information prior to reading the 
links for retrieving the comments from the storage medium, the access authorisation 
information determining whether the links may be used when accessing the 
comments. By retrieving the access authorisation information prior to reading the 
links, access authorisation may already be determined when reading the links. The 
retrieval of access authorisation information may be done as defined above. In that 
case, access management is already carried out within the editor program. Access- 
to the storage medium of the comments thus may only be executed if access is 
permitted within the editor program. Otherwise, no comments may be requested 
from the storage medium. 

[017] During source code coding, comments may usually be provided for 
different elements of the source code. For example, comments may be provided for 
certain lines, procedures, methods, classes or objects within the source code. The 
comment may explain, for example, the purpose or function of the preceding or 
following section of code. Therefore, certain embodiments of the present invention 
assign the links to particular elements of the source code. 

[018] For programmers, it is helpful to see comments within the source code. 
However, the programmers may not always want to see the links, as the links only 
provide the storage information about the comments. Instead, the information 
needed by the programmers or by the customers is included within the comments. 
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Therefore, certain embodiments of the present invention display the comments 
within the source code by replacing the links in the source code with the respective 
comments. 

[019] To provide a higher degree of security, and to avoid manipulating links, 
certain embodiments of the present invention may retrieve access authorisation 
information prior to reading the links, the access authorisation information 
determining whether the link is displayed with the source code or not. That means 
that links may only be displayed for particular users or user groups, and only these 
users or user groups may be allowed to manipulate the links. All other users may be 
excluded to see the links at all. These users may see the appropriate comment or 
do not see anything at all. 

[020] To provide different comments for different users, user groups, source 
code versions, or language versions, certain embodiments of the present invention 
may store more than one comment assigned to a particular element of the source 
code within the database. In that case, for each piece of source code, different 
comments may be provided. These comments may be customized for the particular 
user groups viewing this comment. A programmer needs different information than 
a customer. Therefore, comments for programmers, as well as comments for 
customers may be stored within the database, and presented accordingly. It is also 
possible, to include personal comments, which may only be seen by the particular 
programmer or user. 

[021] To provide easy storage of the comments, and thus allow use of 
generic database programs, certain embodiments of the present invention retrieve 
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all comments when displaying the source code, and the comments are suppressed 
or presented within the source code according to the filter information. In that case, 
the filtering of the comments is only executed within the source code editor. All 
comments are first retrieved from the database. Afterwards, it is decided whether or 
not a comment is presented. 

[022] To provide easy access to the comments, certain embodiments of the 
present invention may store the comments within a database. The database may 
allow storing comments in common format, and accessing these comments using 
generic database queries. 

[023] To provide comments in different languages, certain embodiments of 
the present invention may store language dependent comments within the database, 
retrieve the language information, and present the language dependent comments 
according to the language information. The language information may be used as 
filter information, allowing an embodiment to provide language-customized 
comments. In particular, when programming in teams in different countries, this 
particular embodiment may be preferable. Also, when distributing software to 
different countries, customers might want to see comments intended for them in their 
language. Furthermore, it is possible to translate the comments within the database 
without touching the source code, allowing the source code to remain unchanged. A 
translator may only need to access the database and to translate all comments 
within the database into the appropriate language. Each comment in each language 
is stored within the database. Also, filter information, defining which language the 
comment is assigned to, may be stored. When accessing the comments, the 



8 



appropriate language version of this comment may be retrieved using the filter 
information. 

[024] Filter information may also include, for example, a user role, a user 
group and/or a source code version. The filter information would specify, for 
instance, which user role(s), which user group(s), and/or which source code 
version(s) are permitted to access the comment corresponding to the given filter 
information. All this information may be used for determining, whether a comment is 
presented or not. 

[025] A further aspect of the invention is a computer-implemented method 
for providing comments within source code wherein the comments are stored 
separately from the source code, links providing storage information of the stored 
comments are comprised within the source code, the comments are retrieved from 
the database using the storage information from the links, and the retrieved 
comments are included into the source code. 

[026] A further aspect of the invention is a computer-implemented method 
for providing comments within source code wherein the comments are stored 
separately from the source code, links providing storage information of the stored 
comments are comprised within the source code, access authorisation information 
determining filter information for filtering the comments is used for retrieving the 
comments, the comments are retrieved from the database according to the filter 
information using the storage information from the links, and the retrieved comments 
are included into the source code. 
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[027] Another aspect of the invention is a computer program for associating 
comments with source code, the program comprising instructions operable to cause 
a processor to store the comments separately from the source code; and to identify 
where each of the comments is associated with the source code. 

[028] The program may further comprise instructions operable to cause a 
processor to send request information for retrieving the comments from a storage 
medium, receive the comments from the storage medium and present the received 
comment within the source code. 

[029] Yet, a further aspect of the invention is a computer program product 
with a computer program stored thereon for associating comments with source code, 
the program comprising instructions operable to cause a processor to store the 
comments separately from the source code, and to identify where each of the 
comments is associated with the source code. 

[030] The stored computer program may cause a processor to send request 
information for retrieving the comments from a storage medium, receive the 
comments from the storage medium, and present the received comments within the 
source code. 

[031] Another aspect of the invention is a computer system installed to 
provide comments within source code comprising a first storage storing the source 
code, a second storage storing the comments, the second storage being separate 
from the first storage, a computer in communication with the first storage and the 
second storage, and, a computer program having instructions operable to cause a 
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processor to store the comments separately from the source code, and to identify 
where each of the comments is associated with the source code. 

[032] The computer system may include storage means for storing the 
comments, receiving means for receiving the request for comments from the editing 
computer, processing means for processing the request for comments and for 
retrieving the requested comments, and transmission means for transmitting the 
retrieved comments to the editing computer. 

[033] Further advantages may be derived from the dependent claims. 
Referring now to the drawings, in which like numerals represent like elements 
throughout the several Figures, aspects of the invention and the exemplary 
operating environment will be described. 

BRIEF DESCRIPTION OF THE DRAWINGS 

[034] The accompanying drawings, which are incorporated in and constitute 
a part of this specification, illustrate various embodiments of the invention and, 
together with the description, serve to explain the principles of the invention. In the 
drawings: 

[035] Fig. 1 illustrates an exemplary computer system used to implement 
one or more embodiments of the present invention; 

[036] Fig. 2 illustrates a flow chart of an exemplary method according to one 
or more embodiments of the present invention; 

[037] Fig. 3 illustrates a further flow chart of another exemplary method 
according to one or more embodiments of the present invention; 
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[038], Fig. 4 illustrates an exemplary storage medium including comments 
according to one or more embodiments of the present invention; and 

[039] Fig. 5 illustrates an exemplary computer system according to one or 
more embodiments of the present invention. 

DETAILED DESCRIPTION 

[040] The present invention may be implemented by computers within a 
computer network. An example is illustrated in connection with Figure 1 . 

[041] FIG. 1 illustrates a simplified block diagram of exemplary computer 
system 999 having a plurality of computers 900, 901 , 902 (or even more). 

[042] Computer 900 can communicate with computers 901 and 902 over 
network 990. Computer 900 has processor 910, memory 920, bus 930, and, 
optionally, input device 940 and output device 950 (I/O devices, user interface 960). 
As illustrated, the invention is implemented by computer program product 100 
(CPP), carrier 970 and signal 980. 

[043] In respect to computer 900, computer 901/902 is sometimes referred 
to as a "remote computer." Computer 901/902 may be, for example, a server, a 
peer device or other common network node, and typically has many or all of the 
elements described relative to computer 900. 

[044] Computer 900 may be, for example, a conventional personal computer 
(PC), a desktop device or a hand-held device, a multiprocessor computer, a pen 
computer, a microprocessor-based or programmable consumer electronics device, a 
minicomputer, a mainframe computer, a personal mobile computing device, a mobile 
phone, a portable or stationary personal computer, a palmtop computer or the like. 
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[045] Processor 910 may be, for example, a central processing unit (CPU), a 
micro-controller unit (MCU), digital signal processor (DSP), or the like. 

[046] Memory 920 may be any element or elements that temporarily or 
permanently store data and instructions. Although memory 920 is illustrated as part 
of computer 900, memory can also be implemented in network 990, in computers 
901/902 and in processor 910 itself (e.g., cache, register), or elsewhere. Memory 
920 can be a read only memory (ROM), a random access memory (RAM), or a 
memory with other access options. Memory 920 may be physically implemented by 
computer-readable media, for example: (a) magnetic media, like a hard disk, a 
floppy disk, or other magnetic disk, a tape, a cassette tape; (b) optical media, like 
optical disk (CD-ROM, digital versatile disk - DVD); or (c) semiconductor media, like 
DRAM, SRAM, EPROM, EEPROM, memory stick. 

[047] Optionally, memory 920 may be distributed. Furthermore, portions of 
memory 920 can be removable or non-removable. For reading from media and for 
writing in media, computer 900 uses well-known devices, such as disk drives or tape 
drives. 

[048] Memory 920 stores modules such as, for example, a basic input output 
system (BIOS), an operating system (OS), a program library, a compiler, an 
interpreter, and a text- processing tool. Modules are commercially available and can 
be installed on computer 900. For simplicity, these modules are not illustrated. 

[049] CPP 100 has program instructions and, optionally, data that cause 
processor 910 to execute method steps of the present invention. In other words, 
CPP 100 can control the operation of computer 900 and its interaction in network 
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system 999 so that it operates to perform in accordance with the invention. For 
example and without the intention to be limiting, CPP 100 can be available as source 
code in any programming language, and as object code ("binary code") in a 
compiled form. 

[050] Although CPP 100 is illustrated as being stored in memory 920, CPP 
100 can be located elsewhere. CPP 100 can also be embodied in carrier 970. 

[051] In FIG. 1 , carrier 970 is illustrated as being outside computer 900. For 
communicating CPP 100 to computer 900, carrier 970 may be located in input 
device 940. Carrier 970 may be any computer-readable medium, such as a medium 
explained above (cf. memory 920). Generally, carrier 970 may be an article of 
manufacture having a computer-readable medium with computer-readable program 
code to cause the computer to perform methods of the present invention. Further, 
signal 980 can also embody computer program product 100. 

[052] For the sake of convenience, CPP 100, carrier 970, and signal 980 
have been described in connection with computer 900. Optionally, further carriers 
and further signals may embody further computer program products (CPP) to be 
executed by further processors in computers 901 and 902. 

[053] Input device 940 provides data and instructions for processing by 
computer 900. Device 940 may, for instance, be a keyboard, a pointing device (e.g., 
mouse, trackball, cursor direction keys), microphone, joystick, game pad, scanner, 
or disc drive. Although these examples are devices with human interaction, device 
940 can also be a device without human interaction, for example, a wireless receiver 
(e.g., with satellite dish or terrestrial antenna), a sensor (e.g., a thermometer), or a 
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counter (e.g., a goods counter in a factory). Input device 940 can serve to read 
carrier 970. 

[054] Output device 950 presents instructions and data that have been 
processed. For example, this can be a monitor or a display, (cathode ray tube 
(CRT), flat panel display, liquid crystal display (LCD), speaker, printer, plotter, or 
vibration alert device. Output device 950 can communicate with the user, but it can 
also communicate with further computers. 

[055] Input device 940 and output device 950 can be combined to a single 
device. Any device 940 and 950 can be provided optional. 

[056] Bus 930 and network 990 may provide logical and physical 
connections by conveying instruction and data signals. For the sake of 
convenience, connections inside computer 900 are referred to as "bus 930", while 
connections between computers 900-902 are referred to as "network 990". 
Optionally, network 990 includes gateways, which are computers that specialize in 
data transmission and protocol conversion. 

[057] Devices 940 and 950 are coupled to computer 900 by bus 930 (as 
illustrated) or by network 990 (optional). While the signals inside computer 900 are 
typically electrical signals, the signals in network may be electrical, electromagnetic, 
optical or wireless (radio) signals. 

[058] Networks are commonplace in offices, enterprise-wide computer 
networks, intranets and the Internet (e.g., world wide web WWW). Network 990 can 
be a wired or a wireless network. To name a few network implementations, network 
990 can be, for example, a local area network (LAN), a wide area network (WAN), a 
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public switched telephone network (PSTN); a Integrated Services Digital Network 
(ISDN), an infra-red (IR) link, a radio link, like Universal Mobile Telecommunications 
System (UMTS), Global System for Mobile Communication (GSM), Code Division 
Multiple Access (CDMA), or satellite link. 

[059] Various transmission protocols, data formats and conventions are 
known, including, for example, transmission control protocol/internet protocol 
(TCP/IP), hypertext transfer protocol (HTTP), secure HTTP, wireless application 
protocol (WAP), unique resource locator (URL), unique resource identifier (URI), 
hypertext markup language (HTML), extensible markup language (XML), extensible 
hypertext markup language (XHTML), wireless markup language (WML), and 
Standard Generalized Markup Language (SGML). 

[060] Interfaces coupled between the elements are also well known in the 
art. For simplicity, interfaces are not illustrated. An interface can be, for example, a 
serial port interface, a parallel port interface, a game port, a universal serial bus 
(USB) interface, an internal or external modem, a video adapter, or a sound card. 

[061] Computers and the programs executed on them are closely related. 
As used hereinafter, phrases, such as "the computer provides" and "the program 
provides," broadly refer to express actions by a computer that are controlled by a 
program. 

[062] Figure 2 depicts a flow chart showing one exemplary embodiment of 
the present the invention. In a first step 2, the source code is read by an editing 
program. This typically is done by reading the source code in plain text. In Fig. 2, 
the source code includes the links to comments. In a second step 4, these links are 
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extracted from the source code. The links may be marked by delimiters, identifying 
the links within the source code. This may be usually done by two slashes (7f). 
After extracting the links in step 4, they may be analysed and storage information 
may be retrieved using the links. 

[063] In step 4, filter information assigned to the links may be read. This 
filter information may be used to determine whether the current user is allowed to 
execute this link. The current user may be identified by access authorisation 
information, which may be obtained from the user. If the access authorisation 
information for the current user matches this filter information for the link the link may 
be executed and presented. Otherwise, the link is not presented and not executed. 

[064] It is also possible that the access authorisation information is 
transmitted in step 6 together with the request for comments. In this case, all links 
are executed at first, and then, while retrieving the comments, access authorisation 
information is used for filtering the comments. The request for accessing the 
comments uses the storage information stored within the links. The links define 
where a comment is stored within the database. 

[065] In step 8, the access authorisation information may be extracted from 
the request for comments. Further, in step 8, the comments may be retrieved from 
the database 10. The filter information may be stored with the comment. When 
accessing the comment, the filter information may be read. This filter information 
may be compared with the retrieved access authorisation information. During 
comparison, it may be checked, whether certain comments may be retrieved. It may 
check for a match between the filter information and access authorisation 
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information. In case the access authorisation matches the filter information, access 
to the particular comment may be granted and the comment may be retrieved. On 
the other hand, in case there is no match, the comment may not be retrieved. In 
such a case, a failure message may be generated. If within the filter information the 
access authorisation information is defined as allowable, the comment may be 
retrieved in step 8. 

[066] All comments retrieved and allowable to be presented may be 
transmitted in step 11 to the requesting computer. 

[067] After reception of the comments in the requesting computers, these 
comments may be presented and displayed in step 12 at the appropriate position 
within the source code. This position may be the position of the link for the 
respective comment. Given the proper conditions and configurations, all comments 
for a particular user may be presented in step 12 within the source code. However, 
the user only sees the comments which are intended to be seen. Comments which 
are not intended for this particular user are not displayed within the source code. 

[068] In Figure 3, access control within step 8 is depicted more precisely. In 
step 14, the retrieval information may be analysed. From the retrieval information, 
the stored information for a comment, together with the access authorisation 
information, may be extracted from the request for comments. 

[069] In step 16, the access authorisation information is compared with filter 
information stored together with a respective comment. The filter information 
defines which access authorisation information enables access to a comment and 
also in which case access is to be denied. 
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[070] In step 18, all comments which are allowed to be presented are 
provided. All comments are prepared to be transmitted in step 20 and then provided 
to step 12 of Figure 2. 

[071] Figure 4 depicts the storage of comments within a database. As 
shown in Figure 4, memory 22 comprises a plurality of memory banks 22a-22n for 
accessing the comments, and the links within the source code comprise access 
information to the comments. This access information may lead to a particular 
memory bank. 

[072] An exemplary storage of comments for a link 1 and a link 2 are now 
explained in more detail. Link 1 may comprise information pointing to memory bank 
22a. Within memory bank 22a, a pointer to memory banks 22n-2 - 22n may be 
stored. When accessing the comments for link 1 , this pointer is used to retrieve the 
comments in memory banks 22n-2 - 22n. Within these memory banks, three 
different comments, comment A, B, and C may be stored. Together with these 
comments, filter information may be stored. After retrieval of these comments, the 
filter information may be read and compared with access authorisation information. 
Whether the filter information matches the access authorisation information 
determines which comment may be used. In this case, for example, comment B has 
the appropriate filter information matching the access authorisation information. 

[073] In Figure 4, link 2 within the source code provides information pointing 
to memory bank 22b. Within memory bank 22b, a pointer to memory banks 22f-h is 
stored. This pointer may be used to retrieve comments A', B' and C\ which are the 
appropriate comments to be presented for link 2 within the source code. Also, 
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together with these comments, filter information is stored. Depending on the access 
authorisation information, no comment may be presented, or the appropriate 
comment(s) selected from A', B' and C may be provided and then presented within 
the source code. 

[074] As can be seen, for each link a plurality of comments may be stored. 
These comments may be used for presenting different comments for different users 
according to filter information. 

[075] Figure 5 depicts schematically a computer system according to the 
invention. Depicted is an editing computer 30 and a storage computer 40. Editing 
computer 30 may comprise, for example, a display 32, a processor and input 
periphery for editing source code 34, a processor 36 for processing requests for 
comments, and a transceiver 38. A computer program may also be comprised in the 
computer system. 

[076] Storage computer 40 may comprise, for example, transceiver 42, 
processor 44, and storage medium 46. For accessing comments, the computer 
program may operate the processor 36 to retrieve links to comments from the 
source code using edit means 34. From these links, storage information may be 
retrieved, which may be processed by transceiver 38 via connection 50 to 
transceiver 42 of storage computer 40. 

[077] Within this message, comments may be requested. The request may 
be processed in processor 44 and the appropriate comment may be extracted from 
storage medium 46. In processor 44, filter information of this extracted comment 
may be read. The filter information may be compared with access authorisation 
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information, which has been sent together with the request for comments. If the 
access authorisation information matches the filter information, the comment is 
processed to transceiver 42 and sent via connection 50 to transceiver 38. Within 
transceiver 38, the comment may be received and provided to processor 36. Within 
processor 36, the comment may be assigned to the appropriate link and, in editing 
means 34, the comment may be included within the source code at the appropriate 
position. After the comment has been included within the source code, display 32 
displays the source code together with the comment. 

[078] It is intended that the specification and examples be considered as 
exemplary only, with a true scope and spirit of the invention being indicated by the 
following claims. 
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